Skip to content

docs: document bootstrap-admin and its profile-based targeting#68

Merged
Bccorb merged 1 commit into
mainfrom
docs/bootstrap-admin
Jul 21, 2026
Merged

docs: document bootstrap-admin and its profile-based targeting#68
Bccorb merged 1 commit into
mainfrom
docs/bootstrap-admin

Conversation

@Bccorb

@Bccorb Bccorb commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #66 (profile-based bootstrap-admin targeting), which is now merged.

Summary

The README had no dedicated bootstrap-admin documentation. This adds a "Creating the first admin" section, placed in the natural flow right after "Running your project" and before "Authenticating against an instance", covering:

  • The command and its forms (admin@example.com, --profile prod, interactive prompt).
  • Where it points — target instance resolved from the active profile's instanceUrl (respecting --profile / SEAMLESS_PROFILE), with SEAMLESS_API_URL override and http://localhost:3000 fallback.
  • How it authenticates — the shared bootstrap secret (resolved from .env / auth/.env / docker-compose.yml, else prompted), and why it can't use a login session (it runs before any admin exists).

The --help menu was already updated in #66, so no code changes are needed here — README + changeset only.

Add a "Creating the first admin" section to the README covering the
bootstrap-admin command, how it resolves the target instance from the active
profile (with the SEAMLESS_API_URL override and localhost fallback), and why it
authenticates with the shared bootstrap secret rather than a login session.
@Bccorb
Bccorb merged commit 35700ac into main Jul 21, 2026
1 check failed
@Bccorb
Bccorb deleted the docs/bootstrap-admin branch July 21, 2026 01:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant